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Legend Industries, Ltd. reserves the right to make improvements 
in this manual and the product described within this manual at 
any time and without notice. 
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Improved or Updated versions of the Software described in this 
manual will be made available to the original purchaser for th« 
difference in retail price of the new Software, if any, or a 
minimum «8.00 charge to cover the shipping and handling 
expenses. Please send your original diskette and payment whan 
reguesting a software update to Legend Industries at the 
address at the bottom of this page. 



Legend Industries, Ltd. makes no warranties, althar expressed 
or implied, with respect to this manual or with respect to the 
software described in this manual, its guality, performance, 
merchantability or fitness for any particular purpoee. Legend 
Industries, Ltd. software is sold or licensed "es is". The 
entire risk as to its guality and performance is with the 
buyer. Should the programs prove defective following their 
purchase, the buyer and not Legend Industries, Ltd. (or its 
distributor or retailer) assumes the entire cost of all 
necessary servicing, repair or correction and any Incidental or 
conseguential damages. In no event will Legend Industries, 
Ltd. be liable for direct, indirect, incidental or 
consequential damages resulting from any defect in the 
software, even if Legend Industries, Ltd. has been advised of 
the possibility of such damages. Some states do not allow the 
exclusion or limitation of implied warranties or liability for 
incidental or conseguential damages so the above limitation or 
exclusion may not apply to you. 
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This manual is copyrighted and contains proprietary 
information. All rights are reserved. This document may not, 
in whole or in part, be reproduced in any form whatsoever 
without prior written consent from Legend Industries, Ltd. 
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The Legend 128KDE is a continuation in state— of —the— art 
memorv technology for the Apple II Computer. The 128KDE Soft 
Disk uses "state— of —the— art " 64K RAM chips and requires only 
one slot to emulate a complete, almost instant access, floppy 
disk drive. With no motor speed delay of the disk drive to 
contend with, the 128KDE is as much as 300X faster than the 
standard Apple disk II drive. The 128KDE can be put into any 
slot and can be accessed with the standard Apple DOS 3.3 disk 
drive commands, for example; LOAD, SAVE, READ, WRITE, etc. 

The Legend 128KDE card conforms to the same Device Select 
Address conventions used by Apple Computer Inc. and consequenty 
will act exactly as an Apple Language Card when installed in 
slot and used with the Apple UCSD Pascal, Apple FORTRAN, 
Microsoft CP/M or other systems which utilize a 16K RAM card. 
The 12aKDE is functionally equivalent to two (2) 64KC cards on 
one <1) card. By bank switching eight <8) 16K banks over the 
existing ROM space, the 128KDE Soft Disk enables your Apple to 
triple it's RAM capacity. 

A limitation of microcomputers has been the lack of an 
appropriate amount of RAM storage. The barriers to this 
limitation have been broken with the introduction of the Legend 
Industries 64KC and 128KDE cards. With this advancement in 
state-of-the-art technology the Apple can now address up to 
944K of RAM memory with the appropiate software. 

The Soft Disk software presently available supports up to 
four (4) 128KDE cards, providing up to 512K bytes of storage 
equivalent to four (4) fast access disk drives. A new DOS 
"MOUNT" command enables the user to MOUNT a complete Floppy 
Diskette on to one (1) of the emulated disk drives. A new DOS 
"UPDATE" command copies the contents of the specified emulated 
disk back onto floppy diskette. This usually takes less than 
eighteen <18) seconds. 

The 128KDE Soft Disk has a short 16 conductor cable which is 
used to access timing signals on the Apple mother board. The 
cable plugs into any one of the eight <8> 4116 RAM sockets 
located at row "E" on the mother board. The RAM chip that 
normally occupies this socket is removed and reinserted onto 
the 128KDE card. 

Legend Industries, Ltd. encourages the development of 
sophisticated system software by OEM's which supports the 
Legend 128KDE system. The engineering staff will be happy to 
evaluate any software that is developed for use with the 128KDE 
system on a non-disclosure basis. Please feel free to contact 
the engineering staff at Legend Industries Ltd. 



(Apple II, Apple UCSD Pascal, Apple FORTRAN and Apple Language 

Card are products of Apple Computer Inc. 
«UCSD Pascal is a trademark of Regents U.C.S.D. 
»Microsoft CP/M is a product of Microsoft Inc. 
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The 128KDE adds 128K of RAM (random access memory) to the 
Apple Computer by bank switching 16K banks over the existing 
ROM <read only memory) space. This memory is NOT directly 
addressable, that is to say you must bank switch to take 
advantage of the 128K o* RAM on the board. Bank switching is 
the process o-f selecting one particular 16K bank of RAM or ROM 
to either read or write and is covered in the Theory o-f 
Operation section in this manual. Almost any information can 
be stored in the 128KDE with the appropriate software. Please 
read this manual before using the card so you are more familiar 
with the card and the necessary software to use the card to 
it's fullest extent. Legend Industries is always developing 
software for it's products and as Legend Industries and other 
software houses make available programs using the 64/128K RAM 
cards, the card will prove to be one of the best investments 
you ever made. 



We at Legend Industries encourage you to experiment with the 
card and hope you enjoy using the card as much as wc at Legend 
do. 
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The 128KDE card can be installed in any slot from number 
next to the power supply through number 7 nearest the game 
connector socket. The slot number that you choose is really 
dictated by the type of peripheral cards that already populate 
the peripheral connectors on the mother board and the languages 
and operating systems that you use as well as the intended use 
of the 128KDE card. The Apple Disk Controller, for example, is 
almost always installed in slot 6 while a printer card is 
almost universally installed in slot 1. 

If you choose to install the 12BKDE in slot then the card 
will be recognized as a 16K RAM card when used with Apple DOS 
3.3. Bank #0 on the 128KDE will be loaded with the language 
not contained in ROM on the Apple mother board when you 
initially 'Boot-up' the DOS 3.3 System Master diskette, making 
both languages available to the user. Banks 1 thru 7 on the 
128KDE card still provide 112K of available memory in addition 
to the 48K RAM memory on the Apple mother board. Pascal and 
Microsoft CP/M will also recognize the 128KDE as a RAM board 
when it is installed in slot 0. 

If you program entirely in BASIC or assembly language and 
you have an Integer or Applesoft RDM card installed in slot 0, 
then you may decide to install the 128KDE card in slot 4, or 
any other slot. This provides you with both languages available 
in ROM as well as the full 128K bytes in the 128KDE card in 
addition to the 4SK RAM on the Apple mother board providing 
176K of usable RAM memory. 

If you have an Apple Language Card or similar 16K RAM card 
then you have a choice. You can install the 128KDE in slot 
and the RAM card in some other slot (slot 4 is a good choice) 
or leave the RAM card in slot and install the 128KDE card in 
another slot. Either way you have a total of 192K RAM memory. 
You could also leave the RAM card in slot and install two 
128KDE cards in slots 4 and 5 <any slots will do) for a total 
of 320K of RAM memory and use the DISK EMULATOR program on the 
demo disk to simulate two almost 'instant access' disk drives 
in BASIC. The 128KDE Software suports up to four <4) emulated 
disk drives. 

The 128KDE card has a short 16 conductor cable and connector 
which is used to access critical timing signals available only 
on the Apple mother board. This connector plugs into any one 
of the eight 4116 RAM sockets located at row "E" on the Apple 
mother board. See figure 1.1 

The RAM IC which normally occupies this socket on the mother 
board is removed and installed in the vacant 4116 socket right 
above the ribbon cable on the 128KDE card and the ribbon cable 
is then plugged into the now vacant 4116 RAM socket on the 
Apple mother board. 



« Apple Pascal and DOS 3.3 are trademarks of Apple Computer Inc 
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Read these step-by-step instructions completely before 
rnstr^r:"^ ^^^ '""'^"" *^^ '^^•'^^ "^^^ *" vour Apple? ^^I^prop^ 
the flin^t™?! "'^'^ :^^"'* *" "^''^"^ *^° ^''^ »28K5i board and/^ 
Of th^ r2^re°T"*r- ^^rr instructions assume installation 
?I * Vf ^°^ •'^'^'' *" '=^°* »• I* y°u have any doubts about 
Inllllll-^jrVJ^Tn."''' ^'^" ^^-^ -"^ ^°"^ ''--'- deale^f^ 



Partial view of Apple motherboard 



I/O SLOTS 



O 



oirf^H V J ^"^ ^°"^'' ''^*°''^ removing or installing any 
on ?Ko i ^r"^ '" ''''^ ''PP'^ " computer. Remove the cover 
fL h ^, ""^^^ "^ ^^"*^^ lifting the rear of the cover untfl 
the headlock fasteners unsnap. until 

^^ f^^f^""*.. remove the 4116 RAM IC at location E-3 on the 
Apple mother board with an IC removal tool. See figure ifl 

^' with%hrfA '^°w°^ "^'^ *" *''°"* °* y°"' component side up, 
in^o ^H ^ ^"^* removed from the Apple mother board 

iSsKDE card"" ''m ^^'^^^ ^""* """"^ *^^ ^"'"P"' ""l, on the 
128KDE card Make sure that the index notch on the RAM IC 

"T" on the T^L^ h'"".""^*'' '^ orientated with the number 
1 on the 128KDE board. See figure 1.2 



4) 



Insert the ribbon cable plug from the 128KDE card into the 

thrribr"'"\f* ^°""°" E-3 °" the Apple mother bolrd with 
the ribbon cable on the left. 

5) Install the 128KDE card into the slot peripheral 

i^rt^r;iot."^'^^ ^"--^ *^^* ''- "^'^ '- --^'-^ -" -- -i 

" "^^napfrntHh; ^^cLr^os^^ro^ ^^ ^^ ''^^" "^"^^ "-" 

almoit "fL«^iff " -"emory to your Apple II computer and an 
almost instant access" disk drive. 

in "thrLr^'^f '■^^^"'^ '^^""^ °^"'° '''^'^ *"*° O'-i^'^ 1 and boot -up 
The msk ooer^t?"^" "" '^^^^^^^^'^ i" the Apple DOS 3.3 Manual" 
the H^LQ nroor ^ system will be loaded into RAM memory and 
the ^8KdI carrt ""^-K ^K^'f ■•* " ^"t^-atical ly load Bank on 
mother bofrd <Zt 1 language missing in ROM on the Apple 

mother board (Integer or Applesoft). Verify that the lanouaae 
^n^ Fr"coim:n:s ^'^^^^^'y ''^ switching languages wi^h thll^T 
=k™.ih K ''°""'ands. If the card is operating properly, you 
should be able to switch between languages. operiy, you 

turn* off '*''?i^ '^"^ "°* ^'"'^^'' *° "^ operating correctly then 
r^=t = ,i ! ? ''°'*^'' i""nediately and check for proper 
contact toCr 1 T 'n^"?^" " ^°" """ =**" ^^-^"5 a prob^^^ 
isCi:t: t^rprob^::! °"^'"^- "^ -^ould be able to help you 
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This chapter describes and details the operation o-f the 
128KDE card at the machine and hardware level. It is not 
intended to serve as a tutorial but as a re-ference guide -for 
the user. Use the Apple Reference Manual as an additional 
information source. 



The RAM in the 128KDE card is configured as eight (8> 
individual 16K banks, numbered through 7, which are addressed 
in the «D000 thru «FFFF address space in the Apple. This is 
the same address space used by the BASIC language contained in 
ROM (Read Only Memory) on the Apple mother board. The «O000 
thru *FFFF address space represents only 12K of addressable 
memory and consequently each 16K bank of RAM is further divided 
into two 4K Sub-Banks mapped into the lower 4K address space 
from «D000 thru ♦DFFF. Please note that this is the same 
mapping convention used by the Apple Language Card and, in 
fact, the 128KDE card is functionally identical to eight <8) 
16K Language Cards. 



The 128KDE card Memory Map 



Bank 



Bank 1 



Bank 2 



Bank 3 



♦FFFF 



«F000 



«E000 



«D000 



Bank 4 



Bank 5 



Bank 6 



Bank 7 



»FFFF 



«F000 



«E000 



«D000 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 
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Memory Management is the term used to describe the selection 
of one Bank of memory, either ROM or RAM, to be active in the 
same address space at any one time. The Apple II has used 
memory management for years to select the BASIC ROM's on the 
mother board or the BASIC ROM's on a -firmware card in slot O to 
be mapped into the top 12K o-f address space in the Apple 
computer. This gives the user a choice of having either 
Integer or Applesoft BASIC active in the computer. The Apple 
Language Card is also mapped and managed in this same address 
space. The Language Card contains 16K of RAM memory that can 
be loaded with BASIC and behave like a BASIC ROM card or it can 
be loaded with Pascal or some other operating system making it 
much more flexible than a ROM card. 

Bank O on the 128KDE card will always be recognized as a 16K 
Language Card when the card is installed in slot O and used 
with software designed to work with an Apple Language Card such 
as BASIC, Pascal, etc. Banks 1 through 7 will not be used and 
you may utilize each of these banks as you wish. If you 'boot' 
the Legend 128KDE System disk for example, it will load DOS 
3.3 into the system in the 48K of RAM on the mother board and 
then the HELLO program will load Bank on the 128KDE card with 
the language that is missing in ROM on the mother board. 
Similarly, Apple Pascal and other operating systems designed 
to work with a Language Card will utilize Bank O on the 12BKDE 
card when it is installed in slot O. 



The important thing to remember about managing the memory in 
the 128KDE card is that only one bank of memory may be active 
in the *DOOO thru «FFFF address space at any one time. When 
one of the 16K Banks of RAM on the 128KDE is selected and the 
card is "on" the Inhibit line (pin 32 on the Apple I/O 
connector) is pulled low and the ROM on the mother board is 
disabled. When the RAM is deselected on the 128KDE and the 
card is "off", the Inhibit line' goes high and the ROM on the 
mother board is re-activated. If more than one 128KDE RAM 
card is installed in the Apple Computer, then care must be 
taken to select only one of the cards at any one time. If more 
than one card is selected, the Inhibit lines on the cards will 
conflict with each other and hang the system. 



Selecting and deselecting the RAM on the 128KDE card is 
relatively easy. The 128KDE card is controlled by accessing 
one of the 16 Device Select addresses assigned to its slot. 
Each peripheral slot in the Apple has a unique set of 16 slot 
dependent Device Select addresses. These Device Select 
addresses were designed into the Apple for the purpose of 
controlling the hardware on a peripheral card. 
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Appl 


e Devi ce Sel ect Addresses 






Base 


Slot 


Slot 


Slot 


Slot 


slot 


Slot 


Slot 


Slot 


Addr. 





1 


2 


3 


4 


5 


6 


7 


«C080 


«C080 


♦C090 


«C0A0 


«C0B0 


♦C0C0 


«C0D0 


«C0E0 


«C0F0 


«C081 


«C081 


SC091 


«C0A1 


«C0B1 


♦C0C1 


4C0D1 


«C0E1 


♦C0F1 


«C082 


«C082 


*C092 


SC0A2 


»C0B2 


♦C0C2 


«C0D2 


*C0E2 


»C0F2 


«C083 


*C083 


»C093 


♦C0A3 


«C0B3 


*C0C3 


«C0D3 


4C0E3 


♦C0F3 


«C084 


«C0S4 


«C094 


«C0A4 


«C0B4 


«C0C4 


»C0D4 


«C0E4 


♦C0F4 


»C085 


*C085 


*C095 


«C0A5 


♦C0B5 


«C0C5 


«C0D5 


«C0ES 


«C0F5 


«C086 


«C086 


*C096 


«C0A6 


«C0B6 


«C0C6 


«C0D6 


♦C0E6 


«C0F6 


*C087 


*C087 


*C097 


«C0A7 


*C0B7 


»C0C7 


«C0D7 


«C0E7 


«C0F7 


«C088 


«C088 


*C098 


«C0A8 


«C0B8 


*C0C8 


«C0D8 


«C0E8 


♦C0F8 


*C089 


*C089 


«C099 


«C0A9 


♦C0B9 


*C0C9 


«C0D9 


»C0E9 


»C0F9 


«C08A 


«C08A 


♦C09A 


«C0AA 


«C0BA 


«C0CA 


SC0DA 


♦C0EA 


«C0FA 


«C08B 


«C08B 


«C09B 


«C0AB 


«C0BB 


«C0CB 


«C0DB 


«C0EB 


«C0FB 


*C08C 


♦C08C 


»C09C 


«C0AC 


«C0BC 


«C0CC 


«C0DC 


»C0EC 


«C0FC 


$C08D 


«C08D 


«C09D 


«C0AD 


«C0BD 


♦C0CD 


«C0DD 


«C0ED 


«C0FD 


»C08E 


*C08E 


♦C09E 


«C0AE 


«C0BE 


«C0CE 


♦C0DE 


«C0EE 


«C0FE 


♦C08F 


«C08F 


*C09F 


»C0AF 


*C0BF 


«C0CF 


«C0DF 


♦C0EF 


♦C0FF 



The Device Select addresses used to control the LEBENC 
128KDE card conform to the same Device Select address 
conventions used by Apple Computer, Inc. for implementing the 
Language Card with the following exceptions- 

1) Apple uses only 8 of the 16 Device Selerct addresses 
available at any peripheral slot. Address bit 2 of the 
Device Select address is ignored on the Apple Language 
Card and therefore the addresses ♦C084-«C087 and 
♦C08C-*C08F provide the same control functions as the 
*C080-*C083 and «C088-*C08B addresses. The LEBEND 
128KDE responds to the «C080-*C084 and the «C088-«C08B 
Device Select addresses only. 

2) The LEBEND 128KDE provides a Bank Select address at 
location $C084. This is a Write only address used to 
select bank thru 7. 

Any of the eight <S) banks can be selected by writing to the 
Bank Select Device Select address with a value from ♦00 to ♦07. 
The user can then use the other Device Select addresses to 
select ROM read, RAM read. Write enable RAM or Write protect 
RAM in either the first 4K bank or the second 4K bank. Refer 
to figure 2.3 for the device select address conventions used by 
the LEBEND 128KDE card (addresses used are for slot 0). 



Use the information in Figure 2.2 (you may wish to refer to 
the Apple II Reference Manual, pg. 82) to substitute the 
correct Device Select addresses when accessing the 128KDE card 
from some slot other than 0. For example, the equivalent Device 
Select addresses in the ♦C0C0 through ♦C0CF range would be used 
for a 128KDE card installed in slot 4. 



For the novice and uninitiated, the -following is a very 
simplistic procedure to follow. For the advanced Apple user, 
either disregard the following or you may find it interesting 
to read. In the following discussion, the Legend card is 
assumed to be installed in slot 0. For other slot locations, 
please refer to Figure 2.2- 

Step 1. 

If you have a Disc Drive and/or an auto-start ROM, do not 
insert any disks in your drives at this time. 

Step 2. 

Turn on your Apple and your TV/Monitor. If an auto-start ROM 
is installed, press RESET to stop the disk drive. 



Step 3. 



A ">" symbol should now be in the upper left hand corner of 
the screen. If not, turn off the Apple and recheck Step 2. 



Step 4. 



Get into the monitor by typing 
should now be an asterisk "»". Thi: 
monitor. 



'Call-151'. The cursor 
• is the cursor for the 



Step 5. 



At this point you have the option of doing several things. 
a)You can select RAM read, and write protect RAM by typing 

C080. However if you read RAM with no information in RAM 

you will 'hang' the system. 
b)You can select ROM read and if you type the ROM read 

address *C081 two (2) times, you write enable the Legend 

card. 
c)You can select ROM read and write protect the RAM, by 

typing C082. This will turn "off" the card. 
d)You can select RAM read and if you type the RAM read 

address ♦C083 two (2) times you write enable the card 

with C083. However if you read RAM and there is no 

information in RAM you will 'hang* the system. 
e)You can bank select by typing C084, a write only 

instruction to enable bank through 7. 



Write enable means 
which is enabled. 



you can write or put data into that (RAM) 



Step 6. 



First you must move information (the monitor routine) into 
the Legend card. To do this you must write enable the card 
and still be reading ROM. Type C081 <Press RETURN>, C0B1 
<Press RETURN>. This is typed twice in order to write 
enable the card. 
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Step 7. 



< d C3r-i 



You are now able to write information to the Legend card. 
Type the following to move the Apple monitor routine that is 
stored in ROM up into the Legend card: F800<F800:FFFFM. If 
this is done correctly you will return to the monitor 
cursor. 



Step 8. 



You now have a copy of the Apple monitor in the Legend card. 
For an example type in the following: 300:A9 CI 20 ED FD 18 
67 01 C9 DB D0 Fit 60 <Press RETURN>. Now if you type 300B, 
you should see the alphabet on the screen. 



Step 9. 



You may wish to select RAM read (now you can without hanging 
the system) and see what you have. You should find a copy 
of the Apple monitor routine around $0380. You can do this 
by typing in 0300L, <Press RETURN> and listing (by typinc 
the letter 'L') until you reach your destination. 
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128KDE Device Select Addresses for slot 



2nd Bank 



Ist Bank 



Function 



«C080 
-16256 



«C088 
-16248 



Select RAM read and 
Write protect RAM 



«C081 
-16255 



»C0a9 
-16247 



Select ROM read 

<2 reads will write enable RAM) 



«C082 
-16254 



»C083 
-16253 



«C08A Select ROM read and 

-16246 Write protect RAM 

«C0BB Select RAM read 

-16245 (2 reads will write enable RAM) 



«C084 
-16252 



Bank select (Write only to enable 
bank through bank 7) 



The following pages provide a few simple assembly language 
examples to help clarify the use of the Device Select addresses 
for selecting and deselecting the 128KDE card RAM. It should 
be pointed out that although there are many LDA instructions 
used in these examples the data in the accumulator is not used, 
it is the address itself that is sensed by the 128KDE card. 
You could just as easily use the LDX or other instructions as 
long as it references the Device Select address. The only 
exception is the Bank Select address («C084) which is a 'Write 
only' address that reguires that a value from «00 to *07 be 
written when the address is accessed. All of the following 
examples use the Device Select addresses for a 128KDE card 
installed in slot 0. 



This example shows how to deselect or turn off and write 
protect the RAM on the 128KDE card. Please note that the «C08A 
address could also have been used to perform this particular 
function. 



0800 



0800 8D82C0 
0803 60 



1 

2 
3 
4 

5 
6 

7 
8 

9 



Deselect RAM read and write protect RAM. 
Select ROM read on the mother board. 



Start 



LDA •C082 
RTS 

END 



; Deselect RAM rd. 
; Return to caller 
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This example shows how to deselect or turn off the 128KDE 
card RAM read and enable ROM read on the mother board. This 
example routine also write enables Bank 5 on the 128KDE card 
with the 1st 4K sub-bank mapped into the «D000-*DFFF address 
space. While we have the ROM read enabled we are able to write 
data into RAM on the 128KDE card. 



0800 

0800 

0800 

0800 

0800 

0800 

0800 A905 

0802 8DB4C0 

0805 AD89C0 

0808 AD89C0 

080B 60 

080C 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 



; Select ROM read Sc Writi 
; bank of Bank #5 with 2 

•I 

BankSel EQU SC084 



Start 



LDA »*05 
STA BankSel 
LDA »C089 
LDA ♦C089 
RTS 

END 



> enable 1st 4k sub- 
consecutive reads. 



;Data for Bank #5 
; Select Bank no. 5 
; Select ROM read. 
; Write enable RAM 
s Return to caller 



A copy of the Monitor could be installed in any one of the 
eight (8) 16K banks in the 128KDE card using the following 
routine (example 3). Simply change the operand in line 7 from 
#*00 to #*01, #«02 etc. through #*07 to select Bank 1, Bank 2 
through .Bank 7 respectively. 
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This example shows how to deselect or turn off the 12BKDE 
card RAM read and enable ROM read on the mother board. This 
example also write enables Bank on the 128KDE card with the 
2nd 4K sub-bank mapped into the «D000-«DFFF address space. 
While we have the ROM read enabled we are able to write data 
into RAM on the 128KDE card. This example is expanded to show 
a very short routine called COPYMON which copies the Apple 
Monitor ROM on the mother board at address «F800 to ^FFFF into 
the same address space in Bank on the 128KDE card. 



Notice that the routine uses only one set of zero page 
pointers, PTRL and PTRH. Of particular importance here is the 
fact that any load instruction (line 20) will read RDM on the 
mother board while any store instruction (line 21) will write 
to the 128KDE RAM at the same address contained in PTRL and 
PTRH. 



0800 

0B00 

0800 

0B00 

0800 

0800 

0800 A900 

0802 8D84C0 

0805 AD81C0 

0808 AD81C0 

080B 

080B 

080B 

080B 

080B A900 

080D 8506 

080F A9FB 

0811 8507 

0813 A000 

0B1S B10& 

0817 9106 

0819 C8 
081 A D0F9 
081 C E607 
08 IE D0F5 
0B20 
0820 
0820 

0820 AD82C0 
0823 60 
0824 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 



Select ROM read & Write enable 2nd 4k sub- 
bank of Bank #0 with 2 consecutive reads. 



BankSel EQU •C084 



Start 



PTRL 
PTRH 



COPYMON 



CopyROM 



LDA tt«00 
STA BankSel 
LDA «C081 
LDA «C081 

EPZ »06 
EPZ ♦07 

LDA *«00 
STA PTRL 
LDA ««F8 
STA PTRH 
LDY tt«00 
LDA (PTRL),Y 
STA <PTRL),Y 
I NY 

BNE CopyROM 
INC PTRH 
BNE CopyROM 



;Data for Bank *0 
; Select Bank no.0 
; Select ROM read. 
; Write enable RAM 

; Zero Pg variable 
;Zero Pg variable 

; Address lo byte. 
; Pointer lo byte. 
; Address hi byte. 
5 Points to ♦FB00. 
;Set Y index to 
;Get byte fm ROM. 
;Put byte in RAM. 
;AH 256 bytes ? 
;No, copy another 
; Copied 8 pages ? 
;No, copy another 



; Write protect RAM and return to caller. 



LDA *C082 
RTS 

END 



; Select ROM read. 
; Return to caller 
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One of the interesting aspects of having a language 
contained in RAM on the 128KDE card is that it can be modified 
easily, something you can't do with Read Only Memory (ROM). It 
just so happens that a copy of the Apple Auto-Start Monitor 
resides at address ♦F800 to ♦FFFF in Bank on the card when it 
is loaded with a language by the DOS 3.3 System Master Disk 
(the Auto-Start Monitor is listed in the Apple 11 Reference 
Manual, pg.l36). Many users modify the Auto— Start Monitor to 
include custom functions. These custom Monitors can be copied 
into the RAM on the 128KDE card and utilized when the user 
switches to the language contained in RAM on the card (Integer 
or Applesoft). 

This routine assumes that you have just BLOADed your own 
custom Monitor into memory at address tlOOO and that Bank on 
the 128KDE card has already been loaded with a language. This 
routine will copy the custom Monitor into Bank O RAM. 



08OO 




1 


? 








0800 




2 


5 Select 


ROM 


read & Write enable 2nd 4k sub- 


0800 




3 


; bank of Bank #0 with 2 


consecutive reads. 


0800 




4 


; 








0800 




5 


BankSel 


EQU 


•C084 




oaoo 




6 


; 








08OO 


A900 


7 


start 


LDA 


#*oo 


;Data for Bank #0 


0802 


SD84CO 


8 




STA 


BankSel 


; Select Bank no.O 


0805 


ADBICO 


9 




LDA 


»C081 


; Select HUM read. 


0808 


ADBICO 


lO 




LDA 


»C081 


;Write enable RAM 


080B 




11 


f 








080B 




12 


PTRL 


EPZ 


♦06 


; Zero Pg variable 


080B 




13 


ADRL 


EPZ 


♦08 


; Zero Pg variable 


OBOE 




14 


5 








080B 


A900 


15 


COPYMON 


LDA 


#♦00 


; Address lo byte. 


080D 


8506 


16 




STA 


PTRL 


jPointer lo byta. 


08OF 


8508 


17 




STA 


ADRL 


;Pointer lo byte. 


0811 


A9F8 


18 




LDA 


#*F8 


; Address hi byte. 


0813 


8507 


19 




STA 


PTRL+1 


; Points to ♦FBOO. 


0815 


A910 


20 




LDA 


#♦10 


; Address hi byte. 


0817 


8509 


21 




STA 


ADRL+1 


5 Points to ♦lOOO. 


0819 


AOOO 


22 




LDY 


#♦00 


5 Set Y index to 


081B 


BIOS 


23 


CopyROM 


LDA 


(ADRL) ,Y 


;Get source byte. 


081D 


9106 


24 




STA 


(PTRL) ,Y 


;Put byte in RAM, 


081F 


C8 


25 




I NY 




;A11 256 bytes ? 


0820 


D0F9 


26 




BNE 


CopyROM 


;No, copy another 


0822 


E609 


27 




INC 


ADRL+1 


; Inc page pointer 


0824 


E607 


28 




INC 


PTRL+1 


; Copied B pages ? 


0826 


D0F3 


29 




BNE 


CopyROM 


;No, copy another 


0828 




30 


; 








0828 




31 


; Write 


protect RAM and return to caller. 


082B 




32 


5 








0828 


AD82C0 


33 




LDA 


♦C082 


; Select ROM read. 


082B 


60 


34 




RTS 




; Return to caller 


0B2B 




35 
36 


5 


END 
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Memory Master is a memory management program on the 128KDE 
system disk. Memory Master is used in conjunction with the 
Apple II computer equipped with DOS 3.3 and a 128KDE card. 
This program will work with most 16K cards currently available 
and provides a full 44K bytes of program storage within the 4BK 
on the Apple II motherboard. With the use of this program, an 
additional 8.5K of RAM is made available by relocating DOS into 
one of the first four (4) 16K banks on the 12BKDE card. 

Memory Master will also manage your Integer or Applesoft 
card, providing you have one installed, in any slot in your 
Apple II. 

Memory Master provides many features and several powerful 
extensions to the standard Apple II DOS 3.3 Disk Operating 
System. 

1) Machine language programs can access the DOS RWTS routines 
through the standard DOS page 3 vectors <«3D0 through ♦3EC) 
and no additional page 3 space is used by MEMORY MASTER. 

2) The <.FLIP> command allows the user to "flip" between DOS 
3.3 and DOS 3.2 without re-booting, and best of all, any 
programs residing in memory are unaffected by the "flip". 
What a great way to move a single file from DOS 3.3 to DOS 
3.2, or vice— versa. 

3) The <.SHOW> command promptly displays the current DOS 
version in use. 

4) The <.BSTAT> command dislpays the hexidecimal starting 
address and length of the last Binary file either BLOADed or 
BRUN, a valuable feature for BSAVEing Binary files. 

5) The <.MONITOR> command places the user into the Apple 
Monitor. 

Memory Master is very flexible. Almost any combination of 
cards can be used in the system. Here are some possible system 
configuration considerations. 

1) If you are not using a FIRMWARE card then you should install 
the 128KDE in slot 0. Bank on the 128KDE card will be 
loaded with the missing BASIC language when booting the 
system diskette. In addition, the Pascal Operating System 
will use the card when installed in slot 0. 

2) If you are using your FIRMWARE card then you should install 
it in slot and put the 128KDE in one of the other slots 
(any one available will do). 
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Insert the 128KDE System diskette into the drive and boot-up 
in the normal manner as described in the Apple DOS Manual and 
then type- 

>BRUN MEMORY MASTER 2.0 <Press RETURN> 

The program will begin execution a-fter it has been loaded 
into memory and checks to make sure that DOS is already in the 
machine at the correct address. If there is any problem the 
program returns to BASIC and displays the -following message- 

INCORRECT DOS INSTALLED IN THE MACHINE. 



S^-t «-i.f3 

The program will prompt the user with three important set-up 
questions. These questions are- 

WHAT SLOT IS FIRMWARE CARD IN <0-7) ? O 
WHAT SLOT IS THE RAM CARD IN (0-7) ? 
WHICH BANK SHOULD DOS GO INTO (0-3) 7 O 

The user supplied answers to these questions are used to set 
up the memory management routines incorporated into MEMORY 
MASTER. Let's go through these three questions, one at a time. 

WHAT SLOT IS FIRMWARE CARD IN (0-7) ? O 

Type in the slot number, in the range from through 7, of 
the Integer or Applesoft FIRMWARE card. If no FIRMWARE card is 
installed then simply press RETURN. 

WHAT SLOT IS THE RAM CARD IN <0-7) ? 

Type in the slot number, in the range from O through 7, of 
the LEGEND 128KDE card (or 16K RAM card if you're not using the 
LEGEND 12BKDE card). 

WHICH BANK SHOULD DOS GO INTO (0-3) ? 

If you are using one of the 16K RAM cards then simply press 
RETURN in response to this question. 

If you are using the LEGEND 12BKDE card then type in the 
Bank number, in the range from O through 3, to be used for the 
relocated Disk Operating System. Please note, when the 128KDE 
card is installed in slot O that Bank on the card will 
contain the Language missing in ROM on the Apple mother board. 
Use Bank number 1, 2 or 3 for the relocated DOS. If a FIRMWARE 
card is being used (question 1) then you may use any of the 
four Banks on the 12BKDE card for DOS. 



18 



l^m€=n— v M^i-^iz^r- 



► n ' -t 



The modified Disk Operating System installed in RAM on the 
LEGEND 128KDE card (or 16K RAM card) by MEMORY MASTER is used 
in exactly the same manner as standard Apple DOS 3.3, with the 
following except ions- 

1) The DOS "INIT" command has been disabled. When you need to 
initialize diskettes simply boot-up the SYSTEM MASTER 
diskette which loads standard (and unmodified) Apple DOS 
into the machine and then initialize your blank diskettes. 



2) The DOS "CATALOG" command displays the number of unused 
sectors remaining on each diskette as you catalog it. 



3) Four new DOS commands have been added to the system, 
new commands and their uses are described below. 



These 



_ F^ C3r- 
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The ".FLIP" command will automatically switch between DOS 
3.3 and DOS 3.2. The command works in either direction, that 
is, if you are currently in DOS 3.3 then the flip command will 
place you into DOS 3.2, and vice-versa. 

The ".FLIP" command can be typed in directly from the Apple 
keyboard or it can be used inside your programs by using the 
standard Apple DOS print control-D syntax. Example- 

>100 D*= REM CTRL-D 

>110 PRINT D« ; ".FLIP" 

All programs, pointers and variables remain unchanged during 
the "FLIP" operation. This gives the user the capability to 
transfer files between different types of DOS diskettes (13 and 
16 sector) with a simple "LOAD", ".FLIP" and "SAVE" sequence of 
operations. 



_ S t=tr- - SMOWDOS 

The ".SHOWDOS" command, when typed in from the keyboard, 
displays the current DOS in use, either DOS 3.3 (16 sector) or 
DOS 3.2 (13 sector). 



- IB 
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The ".BSTAT" command, when typed in from the keyboard, 
displays the hexidecimal starting address and length of the 
last Binary type file that was either BLOADed or BRUN. 

This command provides the user with the starting address and 
length parameters required by Apple DOS when BSAVEinq Binary 
type files onto disk. 
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The ".liCHM" command, when typed in from the keyboard, pi 
the user into the Apple Monitor. 



Normally Apple DOS 3.3 will reside from «9600 through «BFFF 
in a 48K Apple and DOS will set HinEli to a value of «9600 
(decimal 38400 or -27136). HEtiORy MASTER uses the top eight 
pages of memory on the mother board for the Memory Management 
Routines <*BF00-«BFFF) and the three DOS File Buffers 
<«B800-«BEFF) and the rest of DOS is relocated into RAM on the 
LEGEND 128KDE card. This allows DOS to set HIMEM to a value of 
«B800 (decimal 47104 or -18432). 



hEMORY MASTER provides machine language access to the DOS 
Read Write Track «e Sector (RWTS) routines through the standard 
DOS page 3 vectors as described in the Apple DOS Manual, 
Chapter 9, pages 94 - 98. The DOS lOB is not relocated into 
RAM on the LESEND 128KDE card but is moved to the ♦BFE8-«BFF8 
address range within the Memory Management Routines for direct 
access by your machine language programs. 



I_x mi -fcai-t i can^ 

MEMORY MASTER remains active in memory until the user 
re-boots. It should be pointed out that any program disks that 
must be booted into operation will disconnect MEMORY MASTER and 
install their own DOS into memory at the standard 4aK address 
(*9600-«BFFF) in the machine. These programs, unfortunately, 
can not take advantage of the extra memory and other features 
of the MEMt»«Y MASTER system. Also, any programs that modify 
pointers internal to DOS or access RWTS directly and not 
through the page 3 vectors, will not work correctly with the 
MEMORY MASTER system active. 
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DOS 
address 



*FFFF 



«FC00 



«F800 



«F400 



«F000 



«EC00 



CE800 



«E400 



»E000 



DOS 3.2 
RWTS / CORE 
subroutines 



«DC00 



«D800 



«D400 



«D000 



Apple 

Monitor 

ROM 



DOS 3.3 
RWTS / CORE 
subroutines 



Buffers 



DOS I/O Package 



Pointers/Tables 



DOS Command 
Processor 



«C000 



«BC00 



«B800 



«B400 



«B000 



«AC00 



«A800 



«A400 



«A000 



«9D00 



EXTENDER 
CMD PROCESSOR 



1st 4K Bank 



2nd 4K Bank 
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ta 



24D5 




609 


«««««««« 


««««< 


t»k««*»««»«»« 


24D5 




610 


» 






24D5 




611 


» <DOS MEMORY MANAGEMENT 


24D5 




612 


*<C) Copyright 1981-Legen 


24D5 




613 


; 






BF00 




614 




ORG 


«BF00 


BF00 




615 




OBJ 


BLOCK 1-* 1800 


BF00 




616 


! 






BF00 


203FBF 


617 


DOSWARM 


JSR 


DOSON 


BF03 


4CBFD5 


618 




JMP 


»9DBF+»3800 


BF06 


203FBF 


619 


DOSCDLD 


JSR 


DOSON 


BF09 


4C84D5 


620 




JMP 


♦9D84+«3800 


BF0C 


203FBF 


621 


IDPKB 


JSR 


DOSON 


BF0F 


20FDE2 


622 




JSR 


»AAFD+«3800 


BF12 


4C63BF 


623 




JMP 


DOSOFF 


BF15 


203FBF 


624 


60RWTS 


JSR 


DOSON 


BF18 


20B5EF 


625 




JSR 


*B7B5+*3800 


BFIB 


4C63BF 


626 




JMP 


DOSOFF 


BFIE 


203FBF 


627 


PKGLOC 


JSR 


DOSON 


BF21 


AD0FD5 


628 




LDA 


♦9D0F+*3S00 


BF24 


AC0ED5 


629 




LDY 


«9D0E+*3B00 


BF27 


4C63BF 


630 




JMP 


DOSOFF 


BF2A 


203FBF 


631 


lOBLOC 


JSR 


DOSON 


BF2D 


ADC2E2 


632 




LDA 


*AAC2+*3800 


BF30 


ACC1E2 


633 




LDY 


*AACl+*3800 


BF33 


4C63BF 


634 




JMP 


DOSOFF 


BF36 


203FBF 


635 


DOSHOOKS 


JSR 


DOSON 


BF39 


205 1E0 


636 




JSR 


«A8Sl+«3800 


BF3C 


4C63BF 


637 




JMP 


DOSOFF 


BF3F 




638 


5 






BF3F 


48 


639 


DOBDN 


PHA 




BF40 


AD82C0 


640 




LDA 


«C082 


BF43 


AD81C0 


641 




LDA 


*C081 


BF46 


ADFABF 


642 




LDA 


BANKNBR 


BF49 


8D84C0 


643 




STA 


«C084 


BF4C 


AD83C0 


644 




LDA 


«C083 


BF4F 


AD83C0 


645 




LDA 


♦C0S3 


BF52 


68 


646 




PLA 




BF53 


60 


647 




RTS 




BF54 




648 


; 






BF54 


203FBF 


649 


DOS IN 


JSR 


DOSON 


BF57 


208 1D6 


650 




JSR 


«D681 


BF5A 


4C63BF 


651 




JMP 


DOSOFF 


BF5D 


203FBF 


652 


DOSOUT 


JSR 


DOSON 


BF&0 


20BDD6 


653 




JSR 


«D6BD 


BF63 




654 


5 






BF63 


08 


655 


DOSOFF 


PHP 




BF64 


48 


656 




PHA 




BF65 


A900 


657 




LDA 


««00 


BF67 


8D84C0 


658 




STA 


♦0084 


BF6ft 


AD82C0 


659 




LDA 


♦C082 


BF6D 


ADF9BF 


660 




LDA 


LANG ID 



Save accufliul ator 
Write prot.cd.#0 
Turn off slot *0 



Select DOS bank* 
Turn on slot # X 
Write enable # X 



Select DOS bank. 
DOS i nput rout ' s 



Select DOS bank. 
DOS Output routs 

;Save P. 
;Save A. 



;Turn off slot #X 
;6et lanq.ID byte 
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BF70 


CD00E0 


661 




CMP 


«E000 


BF73 


F003 


662 




BEQ 


EXITl 


BF75 


AO80C0 


663 




LDA 


«C080 


BF78 


68 


664 


EXITl 


PLA 




BF79 


28 


665 




PLP 




BF7A 


60 


666 




RTS 




BF7B 


2063BF 


667 


ROMSW 


JSR 


DOSOFF 


BF7E 


2C81C0 


668 




BIT 


«C0811 


BF81 


CD00E0 


669 




CMP 


«E000 


BF84 


F00E 


670 




BEQ 


SETLANG 


BF86 


2C80C0 


671 




BIT 


«C080 


BF89 


CD00E0 


672 




CMP 


«E000 


BFBC 


F006 


673 




BEQ 


SETLANG 


BF8E 


08 


674 


EXIT2 


PHP 




BF8F 


203FBF 


675 




JSR 


DOSON 


BF92 


28 


676 




PLP 




BF93 


60 


677 




RTS 




BF94 


8DF9BF 


678 


SETLANB 


STA 


LANG ID 


BF97 


F0F5 


679 




BEQ 


EXIT2 


BF99 




680 


; 






BF99 


2063BF 


681 


I. CHAIN 


JSR 


DOSOFF 


BF9C 


4C36E8 


682 




JMP 


«E836 


BF9F 


2063BF 


683 


I. ERR 


JSR 


DOSOFF 


BFA2 


4CE3E3 


684 




JMP 


«E3E3 


BFA5 


2063BF 


685 


I. COLD 


JSR 


DOSOFF 


BFA8 


4C00E0 


686 




JMP 


«E000 


BFAB 


2063BF 


687 


I . WARM 


JSR 


DOSOFF 


BFAE 


4C03E0 


688 




JMP 


SE003 


BFBl 


2036BF 


689 


A. CHAIN 


JSR 


DOSHOOKS 


BFB4 


2065D6 


690 




JSR 


♦D665 


BFB7 


8533 


691 




STA 


*33 


BFB9 


85D8 


692 




STA 


«D8 


BFBB 


4CD2D7 


693 




JMP 


♦D7D2 


BFBE 


2063BF 


694 


A. ERR 


JSR 


DOSOFF 


BFCl 


4C65D8 


695 




JMP 


«D865 


BFC4 


2063BF 


696 


A. WARM 


JSR 


DOSOFF 


BFC7 


4C3CD4 


697 




JMP 


*D43C 


BFCA 


2063BF 


698 


A. RELO 


JSR 


DOSOFF 


BFCD 


20F2D4 


699 




JSR 


♦D4F2 


BFD0 


4C3FBF 


700 




JMP 


DOSON 


BFD3 




701 


5 






BFD3 


6C3600 


702 


HOOKCSW 


JMP 


(♦0036) 


BFD6 


6C3800 


703 


HOOKKSW 


JMP 


(♦0038) 


BFD9 




704 


5 






BFD9 




705 




HEX 




BFDC 


0000019 


706 




HEX 


000000 


BFDF 




707 




HEX 


000000 


BFE2 


000000 


708 




HEX 


000000 


BFE5 




709 




HEX 


000000 


BFE8 




710 


; 







;Sameas mtherROM? 
; Yes, ret. 2 caller 
;Turn on slot # 
; Restore A. 
; Restore P. 



;Turn off slot *0 
;Is lang.in ROM ? 

;ls lang.in RAM ? 



;Save the Z flag. 



;Save lanq.ID byt 
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BFE8 


01 


711 


I BYTE 


HEX 


01 


BFE9 


60 


712 


IBSLOT 


HEX 


60 


BFEA 


01 


713 


IBDRVN 


HEX 


01 


BFEB 


00 


714 


IBVOL 


HEX 


00 


BFEC 


11 


715 


IBTRK 


HEX 


11 


BFED 


00 


716 


IBSECT 


HEX 


00 


BFEE 


FBB7 


717 


IBDCTP 


ADR 


«B7FB 


BFF0 


E8B7 


718 


IBBUFP 


ADR 


♦B7EB 


BFF2 


0000 


719 




HEX 


Q^Mktfk 


BFF4 


01 


720 


IBCMD 


HEX 


01 


BFF5 


00 


721 


IBSTAT 


HEX 


00 


BFF6 


FE 


722 


IBSnOD 


HEX 


FE 


BFF7 


60 


723 


IDBPSN 


HEX 


60 


BFF8 


01 


724 


lOBPDN 


HEX 


01 


BFF9 




725 


J 






BFF9 


00 


726 


LANGID 


HEX 


00 


BFFA 


00 


727 


BANKNBR 


HEX 


00 


BFFB 




728 


; 






BFFB 


00 


729 


DEVPTC 


HEX 


00 


BFFC 


01 


730 


PPTC 


HEX 


01 


BFFD 


EFD8 


731 


MONTC 


HEX 


EFD8 


BFFF 




732 


5 






BFFF 


B3 


733 


DOSTYPE 


HEX 


B3 


C000 




734 


* 






C000 




735 


«*«««««««»««««««»() 


C000 




736 


; 






C000 




737 




END 





;DOS version 3.3 



»«»« END OF ASSEMBLY 
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The DISK EMULATOR is a remarkably efficient Memory 
Management program for the Apple II computer. This program is 
on the 128KDE System diskette and simulates up to four 
additional, almost instant access, disk drive units for the 
storage and retreival of standard DOS 3.3 disk files. 

NoM, for the first time, every byte of RAM memory on the 
LEBEND 128KDE card can be accessed with the standard DOS 3.3 
disk commands ie. LOAD, SAVE, OPEN, READ, WRITE, etc. in BASIC, 
or the DOS RWTS subroutines in machine language. 

DISK EMULATOR is remarkably compact, using only 512 bytes of 
memory when installed within DOS, yet so very powerful because 
it takes advantage of the organization and power built into the 
DOS 3.3 Disk Operating System. 

A pseudo SLOT/DRIVE number is used to access the emulated 
drive. The user can assign any SLOT/DRIVE number to the DISK 
EMULATOR, and the EMULATOR will not interfere with the operation 
of a peripheral card installed in that slot inside the Apple. 

DISK EMULATOR is as much as 3007. faster than the Apple Disk 
II drive because it eliminates the motor speed, step, nybble 
and search delays associated with the Disk II hardware. 

DISK EMULATOR will use a single 128KDE card to simulate 512 
sectors (tracks 3 thru 34> . Tracks 0,1, and 2 are reserved for 
DOS. 

DISK EMULATOR will support up to four Legend 128KDE cards 

providing a total of S12K bytes (half megabyte) of online 

memory, all organized as four 128K byte, fast access, disk 
drives. 

DISK EMULATOR provides a new <Mount> command, which quickly 
copies the contents of a floppy diskette into the specified 
emulated disk, and a new <Update> command, which copies the 
contents of the specified emulated disk back onto floppy 
diskette, within 18 seconds. 

DISK EMULATOR, like al 1 of the Memory Management software 
from Legend Industries, will support your Integer or Applesoft 
FIRMWARE card (if you have one) installed in any slot. 



The DISK EMULATOR system supports several different 
configurations. If the Legend 128KDE RAM card is installed in 
slot and an Integer or Applesoft FIRMWARE card is installed 
in some other slot then DISK EMULATOR will utilize all of the 
RAM on the 128KDE to provide 512 sectors (128K bytes) of 
storage and use the FIRMWARE card to provide both BASIC 
languages. 
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I-f the Legend 128KDE RAM card is installed in slot O and NO 
Integer or Appleso-ft FIRMMARE card is installed, then DISK 
EMULATOR will retain the first 16K Bank on the card (Bank O) 
for the language missing in ROM on the mother board and utilize 
Banks 1 through 7 on the 128KDE to provide 448 sectors <112K 
bytes) of storage. 

If a 16K RAM card, like the Apple Language card, is 
installed in slot O and the Legend 128KDE card is installed in 
some other slot then DISK EMULATOR will utilize all eight (8) 
16K banks of RAM on the 128KDE to provide 512 sectors <128K 
bytes) of storage and the 16K RAM card in slot will be used 
for the language missing in ROM on the Apple mother board. 

The DISK EMULATOR program needs to know the location of the 
FIRMWARE card, if any, the Emulated slot and drive number (s> 
and the location of the Legend 128K0E card(s) in the Apple 
before it installs itself into the DOS 3.3 Disk Operating 
System. The user can supply this information <ManuaHy> by 
BRUNing the DISK EMULATOR program, or the user can supply this 
information with a < Turn key > Applesoft program to 'bring— up' 
the DISK EMULATOR system automatically. 

Insert the 128KDE System diskette into the drive and boot-up 
in the normal manner as described in the Apple DOS manual and 
then type— 

>BRUN DISK EMULATOR 4.0 <Press RETURN> 

The program will begin execution after it has been loaded 
into memory and checks to make sure that DOS is already in the 
machine at the correct address. If there is any problem, the 
program returns to BASIC and displays the following message- 

INCDRRECT DOS INSTALLED IN THE MACHINE. 

If there are no problems, the Apple screen display should 
look something like this- 



( DISK EMULATOR 4.0 ) <C) COPYRIBHT, 1981 
(MICHAEL D. MC LAREN) LEGEND INDUSTRIES 

ROM FIRMWARE CARD ( LOCATION- SLOT O ) 

DISK EMULATOR #1 ( SLOT X / DRIVE X ) 
( 12aK CARD SLOT X ) 

DISK EMULATOR #2 ( SLOT X / DRIVE X ) 
( 128K CARD SLOT X ) 

DISK EMULATOR #3 ( SLOT X / DRIVE X ) 
< 128K CARD SLOT X ) 



DISK EMULATOR #4 < SLOT X / DRIVE X ) 
< 12BK CARD SLOT X ) 
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Let's input the parameters required by DISK EMULATOR one at 
a time. 

* ROM FIl^MMARE CARD ( LOCATION- SLOT ) 

Type in the slot number, in the range from through 7, of 
the Integer or Applesoft FIRMWARE card. If no FIRMWARE card is 
installed then simply press <RETURN>. . 

The DISK EMULATOR system will manage the selection of the 
language contained on the FIRMWARE card or the language 
contained in ROM on the mother board when the location of the 
FIRMWARE card is reported here. 

The DISK EMULATOR system will use slot as the default slot 
for the language missing in ROM on the mother board when no 
FIRMWARE card is present and consequently will recognize a 16K 
RAM card like the Apple Language card or Bank on the Legend 
12SKDE RAM card when either of these cards is present in slot 
0. 

« DISK EMJLATOR *1 ( SLOT X / DRIVE X ) 

Type in the slot number first, in the range from through 
7, and then the drive number, either 1 or 2, that the first 
Disk Emulator will respond to. If you have a single Disk II 
drive on your Apple II at Slot 6 / Drive 1 then use SLOT 6 / 
DRIVE 2 for the emulated drive. If you have two Disk II drives 
at Slot 6 / Drives 1 and 2 then use SLOT 5 / DRIVE 1 for the 
emulated drive. 

You can use any slot for the emulated drive and it will not 
interfere with the operation of a peripheral card installed in 
that slot. This means that you can use SLOT 5 / DRIVE 1 for 
the emulated drive and it will not interfere with the operation 
of a printer or a modem or any type of card that is physically 
installed in that slot in the Apple. 

»»»* Special Note «««« You should not assign a SLOT / DRIVE 
number to the emulator that is already being used by an Apple 
Disk II drive because this will disable the Disk II drive. 

« ( 128K CARD SLOT X ) 

Type in the slot number, in the range from through 7, of 
the Legend 128KDE RAM card. 

If a FIRMWARE card is present, or if the Legend 128KDE card 
is installed in any slot other than slot 0, then DISK EMULATOR 
will use this card for the storage of 512 sectors of 
information (128K bytes) organized as disk tracks 3 through 34 
as shown in Figure 3.1. 
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128KDE card Memory Map 



f5_ 1 

without BASIC 



Bank 



Bank 1 



Bank 2 



Bank 3 



*FFFF 



*F000 



«E000 



«D000 



Trk 
«03 



Trk 
«06 



Trk 
«05 



Trk 
«04 



Trk 
»07 



Trk 
«0A 



Trk 
♦09 



Trk 
«08 



Trk 
«0B 



Trk 
«0E 



Trk 
«0D 



Trk 
«0C 



Trk 
*0F 



Trk 
*12 



Trk 
«11 



Trk 
«10 



Bank 4 



Bank 5 



Bank 6 



Bank 7 



♦FFFF 



«F000 



«E000 



«D000 





Trk 

♦ 16 

Trk 

♦ 15 


Trk 
♦ 13 


Trk 
♦ 14 





Trk 

♦ lA 

Trk 

♦ 19 


Trk 
♦ 17 


Trk 
♦ 18 





Trk 

♦ IE 

Trk 

♦ ID 


Trk 
♦ IB 


Trk 
♦ IC 




1st 2nd 1st 2nd 
4K Sub-Bank 4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



If a FIRMWARE card is not present and the Legend 128KDE card 
is installed in slot then DISK EMULATOR will retain the first 
16K bank of RAM on the card (Bank 0) for the language missing 
in ROM on the Apple mother board and will utilize Banks 1 
through 7 for the storage of 448 sectors of information (112K 
bytes) organized as disk tracks 7 through 34 as shown in Figure 
3.2. 
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128KDE card Memory Map with BASIC 



Bank 
- BASIC - 



Bank 1 



Bank 2 



Bank 3 



♦FFFF 



♦F000 



♦E000 



♦D000 



♦FFFF 



♦F000 



♦E000 



♦D000 



Bank 4 





Trk 

♦ 16 

Trk 

♦ IS 


Trk 
♦ 13 


Trk 
♦ 14 






Trk 
♦0E 

Trk 
♦0D 


Trk 
♦0B 


Trk 
♦0C 





Trk 

♦ 12 

Trk 

♦ 11 


Trk 
♦0F 


Trk 
♦ 10 



Bank 6 



Bank 7 





Trk 

♦ IE 

Trk 

♦ ID 


Trk 
♦ IB 


Trk 
♦ IC 





Trk 
♦22 

Trk 
♦21 


Trk 
♦ IF 


Trk 
♦20 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



1st 2nd 
4K Sub-Bank 



DISK EMULATOR does not provide for the storage of tracks 0, 1 
and 2 on the emulated drive. These tracks usually contain the 
Disk Operating System <DOS) on a floppy disk and are not 
normally available for the storage of disk files. 



You have 
operation of 
EMULATOR #2, 
< RETURN > in 



Just supplied the parameters necessary for 
EMULATOR #1. If you are not going to implement 
EMULATOR #3 or EMULATCM? #4 then simply press 
response to the emulated Slot / Drive prompts and 



the 128K card Slot assignment prompts for each of the remaining 
three emulators. 
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1+ you have more than two Legend 12BKDE cards and you wish 
to implement EHULATOR #2 then type in the Slot and Drive that 
this emulator will respond to as well as the location of the 
second Legend 128KDE cards just like you did for EMULATOR #1. 
Similarly, type in the parameters for EMULATOR #3 and EMULATOR 
#4 if you wish, or simply press <RETURN> in response to the 
emulated Slot / Drive and 128K Slot prompts for the last two 
EMULATORS. 

t <A)BORT, (DNSTALL OR (R)ESTDRE ? I 

Press 'A' to Abort and return to BASIC without installing or 
restoring the DISK EMULATOR system. 

Press 'I' to Install the DISK EMULATOR system and initialize 
the Directory on all of the emulated disks. DISK EMULATOR will 
automatically set up the Directory on each emulated disk with 
496 free sectors (432 free sectors if Bank on the 1st 128KDE 
card contains BASIC). 

Press 'R' to Restore or reconnect the DISK EMULATOR system 
without initializing the Directory on the Emulated disks. DISK 
EMULATOR is disconnected when you re-boot DOS into the Apple, 
the Restore command is used to reconnect the DISK EMULATOR with 
all of the information on the emulated disks intact. 

The Legend Industries DISK EMULATOR system can be installed 
into the Apple with an Applesoft <Turnkey> program, thus 
eliminating the need to type in all of the Slot and Drive 
parameters that DISK EMULATOR requires for operation. The user 
can RUN the <Turnkey> program to install DISK EMULATOR and then 
display the CATALOG on a disk or the <Turnkey> program can be 
used as the greeting program on a disk to automatically install 
DISK EMULATOR and then RUN some other BASIC program without 
user intervention. 

The <Turnkey> program will BLOAD the DISK EMULATOR file into 
memory and then POKE in the required Slot and Drive parameters 
before installing DISK EMULATOR into the Apple. The <Turnkev> 
program remains in control of the Apple after the installation 
and consequently the last line in the program may be a disk 
command such as CATALOB, to display the Directory of the disk, 
or RUN, to run the users program. 



Before you can 
it to reflect the 
and the location 
Apple. The 
LEBEND disk 
program can 
DISK EMULATOR 



your 
your 
This 
your 



use the <Turnkey> program you must customize 
Slot and Drive numbers of the emulated disks 

of the Legend 128KDE RAM cards installed in 
sample <Turnkey> program called 'TURNKEY' on 
is listed for your convenience in Listing 1. 

be modified to reflect the configuration of 
system. 



LOAD the TURNKEY program into memory and retype line 100 
through line 240 using the following guidelines on the next 
page. 



lOO RC = O 

Use a value in the range from O through 7 that corresponds 
to the location of the Integer or Applesoft FIRMWARE card. 
If no FIRMWARE card is installed then use the value O. 

110 SI = 6 

Use a value in the range from O through 7 that corresponds 
to the SLOT number that EMULATOR #1 will respond to. 

120 Dl = 2 

Use the value 1 or 2 that corresponds to the DRIVE number 
that EMULATOR #1 will respond to. 

130 Kl = O 

Use a value in the range from O through 7 that corresponds 
to the location of the 128KDE card. 

160 S2 = 15 

Use a value in the range from O through 7 that corresponds 
to the SLOT number that EMULATOR #2 will respond to or use 
the value 15 to indicate that EMIA.ATOR #2 will not be 
i mp 1 emented . 

170 D2 = 15 

Use the value 1 or 2 that corresponds to the DRIVE number 
that EMULATOR #2 will respond to or use the value 15 to 
indicated that EMULATOR #2 will not be implemented. 

ISO K2 = 15 

Use a value in the range from through 7 that corresponds 
to the location of a second Legend 128KDE card or use the 
value 15 to indicate that a second card is not available. 

210 S3 = 15 

Use a value in the range from O through 7 that corresponds 
to the SLOT number that EMULATOR #3 will respond to or use 
the value 15 to indicate that EMULATOR #3 will not be 
implemented. 

220 D3 = 15 

Use the value 1 or 2 that corresponds to the DRIVE number 
that EMULATOR #3 will respond to or use the value 15 to 
indicate that EMULATOR #3 will not be implemented. 

230 K3 = 15 

Use a value in the range from O through 7 that corresponds 
to the location of a third Legend 128KDE card or use the 
value 15 to indicate that a third card is not available. 

280 K4 = 15 

Use a value in the range from 1 through 7 that corresponds 
to the location of a fourth Legend 128KDE card or use the 
value 15 to indicate that a fourth card is not available. 
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SAVE this custom <Turnkey> program onto another diskette -for 
testing- 

SflVE TURNKEY <Press RETURN> 

The DISK EMULATOR 4.0 file can also be transferred onto 
another diskette by BLOADing it into memory and then- 

BSAVE DISK EMULATOR 4.0, A»2000, L«AOO < Press RETURN > 
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20 

22 

24 

26 

28 

30 

32 

34 

36 

40 

42 

50 

55 : 

100 

110 

120 

130 

150 

160 

170 

180 

200 

210 

220 

230 

250 

260 

270 

280 

285 

290 

295 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

400 

410 

420 

430 

440 

450 

460 

470 

480 

490 

495 

500 

510 

520 

540 



REM ««<««««»««««*««««««««««« 
REM » « 

« < TURNKEY EMULATOR > « 
* MICHAEL MC LAREN « 
« (C) COPYRISHT 1981 « 



REM 
REM 
REM 
REM 
REM 
REM 
REM 
REM 



LE8END INDUSTRIES, LTD. 

P.O. BOX 112 

PONT I AC, MI. 48056 

t « 

REM «»««««*««»«»«««*»««««««« 

HOME : PRINT "WAIT" 



RC = 00: REM ROM CARD <0 DEFAULT NO CARD) 

51 = 06: REM DEM*1 EMULATES SLOT 6 
Dl = 02: REM DEM«1 EMULATES DRIVE 2 
Kl = 00: REM 1ST 128k DE SLOT 

52 = 15: REM DEM*2 EMULATES SLOT <15 DEFAULT NO EMULATOR) 
D2 = 15: REM DEM#2 EMULATES DRIVE (15 DEFAULT NO EMULATOR) 
K2 = 15: REM 2nd 128KDE SLOT (15 DEFAULT NO CARD) 

53 = 15: REM DEM*3 EMULATES SLOT (15 DEFAULT NO EMULATOR) 
D3 = 15: REM DEM«3 EMULATES DRIVE (15 DEFAULT NO EMULATOR) 
K3 = 15: REM DEM#3 128KDE SLOT (15 DEFAULT NO CARD) 

54 = 15: REM DEM#4 EMULATES SLOT (15 DEFAULT NO EMULATOR) 
D4 = 15: REM DEM#4 EMULATES DRIVE (15 DEFAULT NO EMULATOR) 
K4 = 15: REM DEM*4 128KDE SLOT (15 DEFAULT NO CARD) 

PRINT CHR* (4);"BLOAD DISK EMULATOR 4.0" 

POKE 9697, RC « 16: REM ROM FIRMWARE SLOT 
POKE 9704, SI « 16: REM DEM#1 EMULATED SLOT 
POKE 9705. Dl « 01: REM DEM*1 EMULATED DRIVE 
POKE 9712, Kl » 16: REM DEM»1 12BKDE SLOT 
POKE 9713, Kl « 16: REM DEM#1 128KDE SLOT 

POKE 9706, S2 « 16: REM DEM#2 EMULATED SLOT 

POKE 9707, D2 « 01; REM DEM*2 EMIX.ATED DRIVE, 

POKE 9714, K2 » 16: REM DEM#2 128KDE SLOT 

POKE 9715, K2 « 16: REM DEM#2 128KDE SLOT 



POKE 9708, S3 « 16: 

POKE 9709, D3 « 01: 

POKE 9716, K3 « 16: 

POKE 9717, K3 » 16: 

POKE 9710, S4 « 16: 

POKE 9711,D4 « 01: 

POKE 9718, K4 « 16: 

POKE 9719, K4 « 16: 



REM DEM#3 EMULATED SLOT 
REM DEM«3 EMULATED DRIVE 
REM DEM#3 128KDE SLOT 
REM DEM#3 128KDE SLOT 

REM DEM#4 EMULATED SLOT 
REM DEM#4 EMULATED DRIVE 
REM DEM#4 128KDE SLOT 
REM DEM#4 128KDE SLOT 



CALL 8960: REM CALL INSTALL ROUTINE 



PRINT "DONE " 

PRINT CHR* (4); "CATALOG, S";S!i 



•,D";D1 
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Disk Emulator is the perfect solution for those applications 
that require a lot o-f timely disk access. The user application 
program and its associated disk files can be copied into the 
emulated disk and run from there with a speed improvement of 
approximately Z007. on all of the disk access to the emulated 
disk. 

To gain access to the emulated disk (or disks) simply use 
the optional slot and drive parameters of the emulated disk in 
one of the DOS commands. For example, if emulator #1 emulates 
Slot 5 / Drive 1 then type in the following command. 

>CATALOG, S5, Dl < Press RETURN > 



Once the 
default disk 
command. 



emulated disk has been accessed it remains the 
until another slot and drive is used in a DOS 



The emulated disk Directory does not contain any files when 
you initially install the DISK EMULATOR. You may copy single 
files from floppy disk onto the emulated disk by using the FID 
program on the DOS 3.3 System Master disk or you can copy an 
entire floppy disk onto the emulated disk with the COPY or 
COPYA programs on the System Master disk. 

Disk Emulator provides two new DOS commands for each of the 
four emulated disks. The <Mount> command copies the floppy 
diskette in the Slot and Drive that you specify into the 
emulator that you specify. This command allows the user to 
mount his application software into the emulator quickly, 
usually in less than 18 seconds. 



Command 



Function 



.M1,S6,D1 Copy the floppy diskette in Slot 6 / Drive 1 into 

Emulator #1. 

.M2,S<!>,D2 Copy the floppy diskette in Slot 6 / Drive 2 into 

Emulator #2. 

.M3,S6,D1 Copy the floppy diskette in Slot 6 / Drive 1 into 

Emulator #3. 

.M4,S6,D1 Copy the floppy diskette in Slot 6 / Drive 1 into 

Emulator #4. 

The Mount command i s a true DOS command and i t can be used 
in immediate mode by typing it in at the keyboard or defered 
mode from within a program by using the standard Apple DOS 
print control-D syntax, example- 

BOO PRINT CHR»(4)j".Ml ,86 ,D1- 

The Mount command copies only those tracks on the floppy 
diskette that the emulator can store. If you are emulating a 
full -disk then you will mount tracks 3 through 34 or tracks 7 
through 34 into the emulated disk, depending on whether or not 
Bank O is used to contain the missing language in ROM. 
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When you emulate anything less than a full— disk (32 tracks), 
you must insure that the disk files on the floppy diskette that 
you mount are all located within the specified range of tracks. 

The SPECIAL FORMAT program on your Legend diskette is a 
utility program which helps you set up partial disks especially 
for use with the Mount and Update commands. Use of the SPECIAL 
FORMAT program is described later in this manual. 

The <Update> command copies the contents of the emulator 
that you specify onto floppy disk in the Slot and Drive that 
you specify. This is useful when any data type files have been 
modified during the operation of the users application program. 
The Update command allows the user to record the changes on the 
emulated disk permanently on a floppy diskette. 



Command 



Function 



.U1,S6,D1 Copy Emulator #1 onto the floppy diskette in 

Slot 6 / Drive 1. 
.U2,S6,D2 Copy Emulator #2 onto the floppy diskette in 

Slot a / Drive 2. 
.U3,S6,D1 Copy Emulator #3 onto the floppy diskette in 

Slot 6 / Drive 1. 
.U4,S6,D2 Copy Emulator #4 onto the floppy diskette in 

Slot 6 / Drive 2. 

The Update command is a true DOS command and it can be used 
in immediate mode by typing it in at the keyboard or defered 
mode from within a program by using the standard Apple DOS 
print control-D syntax, exarople- 

900 PRINT CHR«(4)i''-Ul ,S6 ,01" 

The Update command copies only those tracks onto the floppy 
diskette that are contained on the emulated disk. If the 
emulated disk is a full -disk then tracks 3 through 34 or tracks 
7 through 34 will be written onto the floppy diskette, 
depending on wether or not BASIC is contained in Bank on the 
128KDE card. 

** c::#=iLJT I cjiNi ** 

The <Mount> and <Update> commands should be used with 

extreme care. The user should format several floppy diskettes 

as 'Partial' diskettes with the SPECIAL FORMAT program when the 

Disk Emulator is set-up to emulate anything less than a 

full-disk (tracks 3 through 34). Any files that the user 
copies onto these diskettes will be placed in the correct area 
of the diskette. 
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0800 
0800 
0800 
0800 
0800 
0800 
OBOO 
OBOO 
OBOO 
0008 
003E 
0048 
0800 
BF41 
BF65 
0800 
9COO 
9C00 
9COO 
9C00 
9C03 
9C05 
9C06 
9C08 
9C0B 
9C0D 
9C0E 
9C10 
9C13 
9C15 
9C16 
9C17 
9C18 
9C1A 
9C1D 
9C1D 
9C1F 
9C21 
9C23 
9C25 
9C27 
9C2A 
9C2C 
9C2E 
9C31 
9C33 
9C36 
9C38 
9C3A 
9C3B 
9C3C 
9C3E 
9C41 
9C42 



8CFB06 

A206 

88 

B148 

DDE89C 

D009 

C8 

B148 

DDE99C 

F008 

88 

CA 

CA 

lOEC 

4C09BD 

AOOC 

B148 

F06D 

C904 

FOt9 

8DE29C 

A004 

B148 

DDF89C 

905D 

DDF99C 

BOSS 

E902 

4B 

C8 

B148 

8DE19C 

68 

A8 



101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
12S 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 



« « 

« <DISK EMULATOR 4.0> « 

* by Michael D. McLaren (Version 11/02/81) » 
«<C) Copyright 1981-Legend Industries, Ltd.* 
« ALL RIGHTS RESERVED * 

* « 

PTRL EPZ «08 
ADRL EPZ ♦SE 
I OB EPZ «4B 



DOSON 
DOSOFF 



EMTESTl 



DEMTEST 



EQU «BF41 
EQU «BF65 



ORG ♦9COO 
OBJ «0800 



TESTNXT 



EMULATE 



STY 
LDX 
DEY 
LDA 
CMP 
BNE 
I NY 
LDA 
CMP 
BED 
DEY 
DEX 
DEX 
BPL 
JMP 

LDY 
LDA 
BEQ 
CMP 
BEQ 
STA 
LDY 
LDA 
CMP 
BCC 
CMP 
BCS 
SBC 
PHA 
I NY 
LDA 
STA 
PLA 
TAY 



*6F8 
**06 

(IOB),Y 
EMSLOT,X 
TESTNXT 

<IOB),Y 

EMSLOT+l,X 

EMULATE 



DEMTEST 
«BD09 

#«OC 
(IOB),Y 
EXITl 
#«04 
EXITl 
lOBCMD 
««04 
<IOB),Y 
TRKLMT.X 
EXITl 

TRKLMT+1,X 
EXITl 
#«02 



(lOB) ,Y 
SECTOR 



; Index -for 4 test 
Index far lOB * 



Same as EM#X nbr 
No, try next emul 
Index for I OB d# 



Same as EM*X dr« 
Yes, then emul ate 



Index next EM pa 
Tested all 3 par 
No, test next EM. 
Else, ret to RWTS 

; Index for lOB co 
;................ 

; Yes?, ex it emul at 
; Is it -format com 
; Yes then ex i t em 
;Save I OB command 
Index for lOB t# 



Is it tr O, 1 or2 
; Yes then exit em 
; Beyond last trk? 
;Yes then exit em 
;64KC add offset 
;Save new trk val 
; Index for I OB se 



Save pg.# *00-OF 
Retreive tr valu 
Save new tr valu 
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9C43 
9C46 
9C49 
9C4B 
9C4D 
9C4F 
9C50 
9C52 
9C54 
9C56 
9C58 
9C5B 
9C5C 
9C5E 
9C61 
9C64 
9C67 
9C69 
9C6B 
9C6C 
9C6E 
9C70 
9C71 
9C74 
9C76 
9C78 
9C79 
9C7B 
9C7C 
9C7C 
9C7F 
9C80 
9C83 
9C85 
9C88 
9C8A 
9CBD 
9C90 
9C91 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C92 
9C93 
9C95 
9C97 



20B79C 

20929C 

A008 

B148 

853E 

C8 

B148 

853F 

AOOO 

8408 

ADE29C 

4A 

B013 

EAEAEA 

BD83C0 

BD83C0 

B13E 

9108 

C8 

DOF9 

FOOC 

EA 

BD83C0 

B108 

913E 

C8 

DOF9 

EA 

BD82C0 

98 

9D84C0 

AOOE 

ADE39C 

9148 

ADE09C 

20B2A5 

18 

60 



98 
2910 
FOOl 
E8 



155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 



JSR 
JSR 
LDY 
LDA 
STA 
I NY 
LDA 
STA 
LDY 
STY 
LDA 
LSR 
BCS 
HEX 
LDA 
LDA 
WRSECT LDA 
STA 
I NY 
BNE 
BEQ 
HEX 
RDSECT LDA 
RDSECTl LDA 
STA 
I NY 
BNE 
HEX 



EXIT 



EXITl 



LDA 
TYA 
STA 
LDY 
LDA 
STA 
LDA 
JSR 
CLC 
RTS 



SAVLANG 
ADRCALC 
#*08 
<IOB),Y 
ADRL 

<IOB),Y 

ADRL+1 

#♦00 

PTRL 

lOBCMD 

RDSECT 

EAEAEA 

♦C0B3,X 

♦COB3,X 

(ADRL),Y 

(PTRL),Y 

WRSECT 

EXIT 

EA 

*C083, X 

<PTRL),Y 

<ADRL),Y 

RDSECTl 
EA 

♦C0B2, X 

♦C0B4, X 
*«OE 
VOLUME 
<IOB),Y 
LANG ID 
♦A5B2 



Save Ian ID byte 
Set up 128KC add 
Index for I OB bu 
Get buffer lo by 



Index for buf hi 



Init Y index reg 



; Is it RD command 
;YES read sector 
Future DEM xtnsion 
iTurn on 128KC 
;Write enable car 



All 256 bytes mov 
If not, move more 
Else do norm ext 



Select 128KC crd 



All 256 bytes mo 
If not, move more 



;Turn off 128KC 
;Load A w zero va 
; Select bank# O 
} Index for IDB vl 
;Set vol nbr 254 
;...--........... 

;Get lang ID byte 
;DOS ROM switch r 
; Indicates no err 
s Return to call r 



ADRCALC- Y 



register - Track value 7.000XXXXX 

Indicates one of 32 (4K) tracks 
X register - 128KC index XOOOOOOXX 

Indicates one of three EMULATORS 
SECTOR - Sector nbr. 7.0000XXXX 

Indicates page number tOO to tOF 

ADRCALC subroutine returns with hi -byte 
of 128KC add. in PTRL+1 ptr. Register 
X contains index for correct 128KC slot. 

ADRALC TYA ; Retrieve track v 

AND #■/. 5 1st or 2nd card? 

BEQ CONTl ; Branch if card#l 

INX ; Index for card#2 
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9C98 


BDF09C 


210 


CONTl 


LDA 


NDXTBL, X 


9C9B 


AA 


211 




TAX 




9C9C 


98 


212 




TYA 




9C9D 


291C 


213 




AND 


#7. 


9C9F 


4A 


214 




LSR 




9CAO 


4A 


215 




LSR 




9CA1 


9D84C0 


216 




STA 


*C084,X 


9CA4 


98 


217 




TYA 




9CA5 


2903 


218 




AND 


#'/. 


9CA7 


A8 


219 




TAY 




9CA8 


D004 


220 




BNE 


CONT2 


9CAA 


8A 


221 




TXA 




9CAB 


6908 


222 




ADC 


#*08 


9CAD 


AA 


223 




TAX 




9CAE 


B9E49C 


224 


l;unt2 


LDA 


ADRTBL, Y 


9CB1 


6DE19C 


225 




ADC 


SECTOR 


9CB4 


8509 


226 




STA 


PTRL+1 


9CB6 


60 


227 




RTS 




9CB7 




228 


; 






9CB7 


ADOOEO 


229 


SAVLANB 


LDA 


♦EOOO 


9CBA 


BDE09C 


230 




STA 


LANBID 


9CBD 


ADS2CO 


231 




LDA 


♦C082 


9CCO 


ADS ICO 


232 




LDA 


♦C081 


9CC3 


60 


233 




RTS 




9CC4 




234 


9 






9CC4 


B13E 


235 


WRDEM 


LDA 


(ADRL),Y 


9CC6 


9900BD 


236 




STA 


♦BDOO, Y 


9CC9 


C8 


237 




I NY 




9CCA 


DOF8 


238 




BNE 


WRDEM 


9CCC 


4C65BF 


239 




JMP 


DOSOFF 


9CCF 


2065BF 


240 


RDDEM 


JSR 


DOBOFF 


9CD2 


BD83C0 


241 




LDA 


♦C083,X 


9CD5 


B108 


242 


RDDEMl 


LDA 


<PTRL),Y 


9CD7 


9900BD 


243 




STA 


♦BDOO,Y 


9CDA 


C8 


244 




I NY 




9CDB 


D0F8 


245 




BNE 


RDDEMl 


9CDD 


4C41BF 


246 




JMP 


DOSON 


9CE0 




247 


5 






9CE0 


OO 


248 


LANBID 


HEX 


00 


9CE1 


00 


249 


SECTOR 


HEX 


OO 


9CE2 


OO 


250 


lOBCMD 


HEX 


00 


9CE3 


FE 


251 


VOLUME 


HEX 


FE 


VL;h4 




252 


9 






9CE4 


DO 


253 


ADRTBL 


HEX 


DO 


9CE5 


DO 


254 




HEX 


DO 


9CE& 


EO 


255 




HEX 


EO 


9CE7 


FO 


256 




HEX 


FO 


9CE8 




257 


9 






9CE8 




258 


; Hardwar 


e con-fig. bloc 


9CE8 




259 


9 






9CE8 


5001 


260 


EMSLOT 


HEX 


5001 


9CEA 


FFFF 


261 




HEX 


FFFF 


9CEC 


FFFF 


262 




HEX 


FFFF 


9CEE 


FFFF 


263 




HEX 


FFFF 


9CF0 


2040 


264 


NDXTBL 


HEX 


2040 


9CF2 


FFFF 


265 




HEX 


FFFF 



sBet 128KC slot 
; Put in X index r 
(Retrieve trk val 
;Ma5k -for bank no 



Set correct bank 
Retrieve trk val 
Mask for 4K bnks 
Index for 128KC 
Branch if not 1 

1st 4K sub-bank 

Bet 128KC add hi 
Add sector OO-OF 
Save pointer hi-b 
Return to cal 1 r 



Wr.Prot.slot #0. 
Turn o-ff slot #0 
Return to cal 1 r 



Select 128KCard 



Vol.# -Found 254. 



; 1st 4K sub— bank 

J 2nd 4K sub-bank 

; 2nd 4K sub-bank 

5 2nd 4K sub-bank 



;EM#1 slot/dr.# 
;EM#2 slot/dr.# 
EM#3 slot/dr.# 
EM»4 slot/dr.# 
EM#1 1st /2nd i 
EM#2 lst/2nd i 



9CF4 


FFFF 
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HEX 


FFFF 


9CF6 


FFFF 


267 




HEX 


FFFF 


9CF8 


0323 


268 


TRKLMT 


HEX 


0323 


9CFA 


0323 


269 




HEX 


0323 


9CFC 


0323 


270 




HEX 


0323 


9CFE 


0323 


271 




HEX 


0323 



272 



«*»« END OF ASSEMBLY 



END 



;EM#3 1st /2nd 
;EM#4 lst/2nd 
;EM#1 beg /end 
;EM#2 beg/end 
5EM#3 beg /end 
;EM#4 beg /end 
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The SPECIAL FORMAT program allows the user to create special 
'partial' diskettes which may be used for the storage of disk 
files. The SPECIAL FORMAT program will initialize a blank 
diskette and then mark the Volume Table Of Contents <VTOC) in 
the Directory of the diskette to show that only the tracks in 
the specified range are available for the storage of disk 
files. 

Once the floppy diskette has been formatted and marked as a 
'partial disk' the user may copy individual files onto it with 
the Apple FID program on the System Master disk. All files 
will be written onto the disk in the specified range of tracks. 
This insures that the <Mount> and <Update> commands will move a 
valid range of tracks to and from the emulated disk. 

To use the SPECIAL FORMAT program simply insert the Legend 
disk into the drive and type- 

RUN SPECIAL FORMAT (press RETIJRN) 

The program clears the screen and then prompts the user with 
three important set-up questions. 

QREETINB PROGRAM - 

Type in the name of the greeting program you intend to use 
on the new diskette. The SPECIAL FORMAT program does not place 
the greeting program on the new disk, it simply places the 
greeting program name into the proper area of DOS on the new 
disk. 

BEBINNINB TRACK (3 OR 7> - 

If the 128KDE card is installed in slot and no Integer or 
Applesoft FIRMWARE card is installed in the computer^ then Disk 
Emulator will retain the first 16K Bank of RAM on the card for 
the BASIC language missing in ROM on the Apple mother board. 
This prevents the use of the first four tracks on the emulated 
disk, tracks 3 through 6, so type in the value '7' in responce 
to this question. 

If the 12BKDE card is installed in any slot other than slot 
OR if an Integer or Applesoft FIRMWARE card is installed, then 
type in the value '3' in responce to this question. 

ENDING TRACK < 18 OR 34) - 

If a 64KC card is installed in the system and you wish to 
format a "half-disk" using this card, type in the value 'IB'. 
If a 128KDE card is installed in the system and you wish to 
emulate a "full-disk", type in the value '34'. 

INSERT BLANK DISK AND PRESS < RETURN > 

Insert a blank disk into the drive and press <RETURN> or any 
other key. When the disk has been initialized, the user can 
place the greeting program and other application programs onto 
it. 
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i-t ± r-»g :3 



20 

22 

24 

26 

28 

30 

32 

34 

36 

40 

42 

44 ! 

50 

55 ! 

100 

110 

120 

130 

140 

150 

170 

180 

200 

210 

220 

230 

250 

260 

270 

280 

300 

310 

320 

350 

360 

370 

380 

390 

400 

410 



REM ««««««*«««««««««**«««««« 

REM « * 

REM « < FLOPPY FORMATTER > « 

REM * MICHAEL MC LAREN t 

REM « (C) COPYRIBHT 1981 « 
REM 

REM LEGEND INDUSTRIES, LTD. 
REM P.O. BOX 112 
REM PONT I AC, MI. 48056 

REM <t « 

REM «««»««««««««««(««»«»*««« 

HOME : PRINT "WAIT" 

FOR I = 1 TO 40! PRINT "=";: NEXT 
PRINT " SPECIAL DISK FORMAT PROBRAM" 

PRINT " <C) COPYRIBHT 1981, LEGEND INDUSTRIES" 

FOR I = 1 TO 40: PRINT "=";: NEXT : PRINT 

VTAB 7: INPUT "GREETING PROGRAM - ";GN« 
IF BN* = "" THEN GN» = "HELLO" 

VTAB 9: INPUT "BEBINNIN6 TRACK <3 OR 7) - ";BT« 
BT = VAL (BT«) 
IF BT < 3 OR BT > 11 THEN PRINT "": GOTO 200 

VTAB 11: II>ff>UT "ENDING TRACK <18 OR 34) - ";ET* 
ET = VAL (ET») 
IF ET < > 18 AND ET < > 34 THEN PRINT "": GOTO 250 

VTAB 14: PRINT "INSERT BLANK DISK AND PRESS < RETURN > "5 
BET A«! PRINT 

POKE - 2081.3, BT « 4: REM BEBIN TRACK 
POKE - 20811, (ET +11) « 4: REM END TRACK 

PRINT CHR« (4);"INIT"!BN» 
PRINT CHR« <4); "DELETE" ;GN« 

POKE - 20813,12: POKE - 20811,140 
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:-tc3r- 



The Firmware Selector utility program was written especially 
-for Apple II users that own either an Integer or Applesoft 
FIRMWARE card as well as the Legend 64KC or 128KDE RAM card. 
At last, the power and -flexibility o-f a RAM card in slot O for 
Pascal, Fortran, etc. and the convenience o-f a FIRMWARE card in 
some other slot -for Integer BASIC or Appleso-ft BASIC. 

The Firmware Selector program may be used to modify the DOS 
on your DOS 3.3 diskettes to recognize a FIRMWARE card 
installed in any slot inside the Apple. A DOS 3.3 diskette 
that has been modified using the Firmware Selector program 
will, when booted, recognize and control the selection and 
deselection of the FIRMWARE card installed in the slot that you 
specified. 



The Firmware Selector program is easy to use. Simply RUN 
FIRMWARE SELECTOR on the Legend diskette. The program will 
prompt you to insert a standard DOS 3.3 diskette into the drive 
and then press <RETURN>. Be sure to remove the write protect 
sticker on the DOS 3.3 diskette before inserting it into the 
drive. The program will read this diskette and display the 
current slot number that the DOS on this diskette will use when 



FIRMWARE cas d (normally slot O) and prompt you 
for a new slot number. Type in a slot number in the range from 
O through 7 that corresponds to the new location of the 

in your system (slot 4 is a good choice). The 
modifies two bytes in the ROM switching routine 
(RDMSW) within DOS on this disk. 



referencing a 



FIRMWARE card 
program then 



That's all there is to it. The modified diskette, when 
booted, will automatically recognize your FIRMWARE card 
installed in slot 4 or any other slot that you selected and 
your Pascal disks, when booted, will work fine with the Legend 
RAM card installed in slot O. 
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20 REM *»*******»»»*****«**«*** 

22 REM « * 

24 REM » FIRMWARE SELECT PROG * 

26 REM * (MICHAEL D. MCLAREN) * 

30 REM * * 

32 REM * (C) COPYRIGHT 1981 * 

34 REM * ALL RIGHTS RESERVED I * 

38 REM 

40 REM LEGEND INDUSTRIES LTD. 

42 REM P.O.BOX 112 

44 REM PONTIAC, MI. 48056 

46 REM 

48 REM « * 

50 REM **»***»««*****»******««* 



100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
430 
440 
450 
460 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 



TEXT : HOME 

FOR I = 1 TO 40! PRINT "=";! NEXT 

PRINT '■ LEGEND FIRMWARE SELECT PROGRAM" 

PRINT "(C)OPYRISHT 1981 LEGEND INDUSTRIES LTD." 

FOR I = 1 TO 40! PRINT "=";! NEXT : PRINT 

GOSUB 460 

PRINT " THIS PROGRAM WILL MODIFY THE LANGUAGE 
PRINT "SWITCHING ROUTINE <ROMSW) WITHIN DOS ON 
PRINT "YOUR DOS 3.3 DISKETTES TO AUTOMATICALLY 
PRINT "RECOGNIZE AN INTEGER OR APPLESOFT FIRM- 
PRINT "WARE CARD INSTALLED IN SLOT THRU 7." 
PRINT : PRINT 



PRINT " INSERT TARGET DISK AND PRESS < RETURN > 
CALL 769: REM READ TRK. 1 SCT.4 
POKE 34,4: HOME ! POKE 34,0: PRINT 

PRINT " THE DOS ON THIS DISKETTE. WHEN BOOTED. "; 
PRINT " WILL RECOGNIZE AN INTEGER OR APPLESOFT "; 
PRINT " FIRMWARE CARD INSTALLED IN SLOT NBR. "! 
INVERSE ! PRINT ( PEEK (6328) - 128) / 16: NORMAL 

VTAE 10! PRINT " NEW FIRMWARE CARD SLOT NUMBER (0-7)? 
SL = VAL (SL«)! IF SL < OR SL > 7 THEN 340 
INVERSE : PRINT SL*! NORMAL 



BET A«: PRINT 



GET SL 



POKE 6328,128 + SL * 16: POKE 63 
CALL 773: REM WRITE TRK. 1 SCT.4 



56, 129 + SL * 16 



PRINT 
PRINT ! 
END 

RESTORE 



PRINT 
IF A* 



UPDATE ANOTHER DISKETTE 
"Y" THEN 100 



BET A* 



DATA 000, 
DATA 032. 
DATA 003, 
DATA 200, 
DATA 145. 
DATA 200, 
DATA 145, 
DATA 144, 



FOR I 

169. 
227, 
169, 
169, 
072, 
169, 
072, 
005, 



768 TO 831: READ D: POKE I,D: NEXT 



RETURN 



001 
003 
000 
001 
160 
024 
032 
169 



208, 
132, 
141, 
145, 
008. 
145, 
227, 



002, 
072, 
000, 
072, 
169. 
072. 
003, 
141, 
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169, 002, 



133, 
003, 



073, 
145, 



200, 169, 

000, 145, 

160, 012, 

032, 217, 

000. 003, 



072 
160 
072 
004 
072 
104 
003 
096 



SiEgctiJi 3n5u0tr«fi Ctlr, 



